步骤 12:打包 Debug 和 Release

注意: 此示例适用于单配置生成器,不适用于多配置生成器(例如 Visual Studio)。

默认情况下,CMake 的模型是一个构建目录仅包含单个配置,无论是 Debug、Release、MinSizeRel 还是 RelWithDebInfo。 然而,可以设置 CPack 来捆绑多个构建目录,并构建一个包含同一项目的多个配置的软件包。

首先,我们希望确保 debug 和 release 构建为将要安装的库使用不同的名称。 让我们使用 d 作为 debug 库的后缀。

在顶层 CMakeLists.txt 文件的开头附近设置 CMAKE_DEBUG_POSTFIX

CMakeLists.txt
set(CMAKE_DEBUG_POSTFIX d)

add_library(tutorial_compiler_flags INTERFACE)

以及教程可执行文件上的 DEBUG_POSTFIX 属性

CMakeLists.txt
add_executable(Tutorial tutorial.cxx)
set_target_properties(Tutorial PROPERTIES DEBUG_POSTFIX ${CMAKE_DEBUG_POSTFIX})

target_link_libraries(Tutorial PUBLIC MathFunctions tutorial_compiler_flags)

我们还要为 MathFunctions 库添加版本编号。 在 MathFunctions/CMakeLists.txt 中,设置 VERSIONSOVERSION 属性

MathFunctions/CMakeLists.txt
set_property(TARGET MathFunctions PROPERTY VERSION "1.0.0")
set_property(TARGET MathFunctions PROPERTY SOVERSION "1")

Step12 目录中,创建 debugrelease 子目录。 布局将如下所示

- Step12
   - debug
   - release

现在我们需要设置 debug 和 release 构建。 我们可以使用 CMAKE_BUILD_TYPE 来设置配置类型

cd debug
cmake -DCMAKE_BUILD_TYPE=Debug ..
cmake --build .
cd ../release
cmake -DCMAKE_BUILD_TYPE=Release ..
cmake --build .

现在 debug 和 release 构建都已完成,我们可以使用自定义配置文件将两个构建打包到单个 release 中。 在 Step12 目录中,创建一个名为 MultiCPackConfig.cmake 的文件。 在此文件中,首先包含由 cmake 可执行文件创建的默认配置文件。

接下来,使用 CPACK_INSTALL_CMAKE_PROJECTS 变量来指定要安装的项目。 在本例中,我们要安装 debug 和 release。

MultiCPackConfig.cmake
include("release/CPackConfig.cmake")

set(CPACK_INSTALL_CMAKE_PROJECTS
    "debug;Tutorial;ALL;/"
    "release;Tutorial;ALL;/"
    )

Step12 目录中,运行 cpack,使用 config 选项指定我们的自定义配置文件

cpack --config MultiCPackConfig.cmake